home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / vuucp223.zip / VUUCP2.DOC < prev   
Text File  |  1994-02-08  |  12KB  |  255 lines
  1. VUUCP/2- VUUCP Replacement for VBBS 6.10+
  2. Copyright 1993 Scott Call
  3. -----------------------------------------
  4. Release 2.3
  5.  
  6. ALL NEW DOCUMENTATION!  PLEASE READ THROUGH.
  7.  
  8. Welcome to VUUCP/2 2.3 
  9.  
  10.     Thank you for choosing the ONE fully-functional interface
  11. to VBBS and the InterNET/USENet.  This will be the last full release
  12. (barring any bug fixes) before VUUCP/2 3.0 which will be in 'C', and
  13. not need waffle.  VUUCP/2 3.0 will also have, hopefully, an OS/2 32-bit
  14. native mode executable available.  I have tried to simplify installation as much
  15. as possible, given the timeframe I allow myself for programming, and hope it's 
  16. as painless as possible.
  17.  
  18.     If you are having trouble installing the WAFFLE program, please refer
  19. to the included 'Examples.Doc' file that contains a my complete set up for WAFFLE.
  20.  
  21.     To Upgrade an Existing Copy of VUUCP/2 (Or R.D.G's VUUCP):
  22.         UnZip the VUUCP223.zip file into your vbbs directory
  23.         Run the following: CONVERT NETWORKID=x (where x is the slot you use)
  24.         The KEYS.x file is no longer needed
  25.         NOTE: If there is an error the first time you run the new version,
  26.             try deleted the MAIL file in the WAFFLE/ADMIN directory.
  27.  
  28.  
  29.     New Installation:
  30.         First you must obtain a news and mail feed
  31.             (Services Include: NetCom, HoloNet, CRL, CCNet, etc..)
  32.         Install WAFFLE 1.65 (or greater) as you would if you were running it. 
  33.             (see WAFFLE docs and EXAMPLE.DOC)
  34.         Get WAFFLE operational in it's ability to send/recieve mail and news
  35.         UnZip VUUCP223.ZIP into your VBBS directory
  36.         Configure the network information with VCONFIG (usually slot 5 or 9)
  37.         Run VUU2CFG.EXE (included with VUUCP223.ZIP) 
  38.         Make sure all options are set correctly (for a detailed view of what 
  39.             each option means, see the table below)
  40.         Run the command VUUCP /D NETWORKID=x to see if all is well.
  41.  
  42.     Setting up E-mail functionality:
  43.         E-Mail functionality is built into VUUCP with no additional setups
  44.         Make sure the USER directory in VCONFIG is the same as the one
  45.             in your waffle/static file.
  46.         A User must send out an e-mail or post to a newsgroup in order to
  47.             be able to recieve e-mail.
  48.         The Username is derived from the first 8 characters of the user's handle.
  49.         Dr, Mr, and The are deleted from the begining of usernames
  50.         Duplicate usernames are issued usernames in ascending order
  51.             (ie bob, bob1,bob2,bob3)
  52.         
  53.     Setting up NewsGroup functionality:
  54.         Newgroups are a bit hard to set up than E-Mail
  55.         To setup a newsgroup in WAFFLE, edit the waffle/system/usenet file
  56.         Add the complete name of the newsgroup onto the bottom of the file
  57.         Use One line per newsgroup.
  58.         To Setup newsgroups in VBBS:
  59.         Go into Vconfig, and create a message database as usual
  60.         Under network configuration, select the UUCP type network you are using
  61.         Enter the complete name of the newsgroup into the network indentifier
  62.         Repeat untill all new newsgroups have been added.
  63.         Use VCONFIG to compile network information for databases
  64.         Contact the administrator at the site you connect to and
  65.             request that the newsgroups you want be added to 
  66.             your feed.
  67.         All should work well.
  68.  
  69. NOTE on Warnings:
  70.         VUUCP will warn you, with red writing, and a message in the log file
  71.     (If it's turned on) that certain directories don't exist.  Don't worry about the
  72.     messages if they are refering to a newsgroup's directory, because WAFFLE
  73.     doesn't create the newsgroup directories until it recieves a message in that group.
  74.     If the warning references a user directory there may be a problem, contact me, 
  75.     the author, for help.
  76.  
  77. Organization Lines:
  78.         To add an Organization: line to all your outgoing news and mail,
  79.     add the following line to the vbbs/data/net.x file (again, x refers the the network slot)
  80.     organ=SomeGreatEtherialBBS (xxx)xxx-xxxx 
  81.  
  82. Deleting Users:
  83.         One of the reasons the KEYS file concept was abadoned was that it made
  84.     life difficult for SysOps who wanted to delete individual users from their system.
  85.     In VUUCP/2 2.3, all one needs to do to delete a user is to delete the directory    
  86.     named after them in Waffle's USER directory.  There will be at least one file in
  87.     each user directory, "VUUCPUSR.DAT" don't worry about deleting this, it's unneeded
  88.     once the user has been deleted.
  89.  
  90. Command Line Switches:
  91.     The following command line switches are available in VUUCP/2:
  92.         VUUCP /A Networkid=x    <-- Answer incoming UUCP type call
  93.         VUUCP /D     "             <-- Dial out (Calls POLL.BAT)
  94.         VUUCP /R    "        <-- Import mail/news from WAFFLE to VBBS
  95.         VUUCP /U     "        <-- Export mail and news to WAFFLE from VBBS
  96.  
  97. VUUCP/2 and VBBS-OS/2:
  98.     I am personally running this version of VUUCP/2 and WAFFLE 1.65 flawlessly
  99.     under IBM's masterpiece, OS/2.  I am useing Ray Guinn's SIO driver, and
  100.     have WAFFLE set to run off a FOSSIL driver.  Contact me if you have problems.
  101.     VUUCP/2 3.0 will, of course, circumvent all these problems.
  102.  
  103. Known Errors:
  104.     After exporting a post into a newsgroup, VUUCP/2 will often start spitting the 
  105.     following out onto the screen:
  106.             ACCESS DENIED
  107.                 or
  108.             FILE NOT FOUND 
  109.     Don't worry, that's a cosmetic problem that will be cured soon enough.
  110.  
  111.             
  112. Distribution of this or any other program written by Scott Call is
  113. limited to free, public access BBSs.  No fee shall be charged for the files,
  114. and any charge for media (CD-ROM/etc.)  must be approved by the author.
  115. Violation may result in prosecution.
  116.  
  117. VUUCP/2 2.3 Highlights/additions:
  118.     FIXED all known bugs, including the elusive 'illegal function call in line 0'
  119.     FIXED problem with duplicate user addresses in a better way than before.
  120.     FIXED problem with invalid characters in usernames.
  121.     Changed the file formats around to be able to handle an unlimited number
  122. of users.
  123.     Changed E-Mail routines completely, resulting in speed increases upwards of 
  124. 500% in email importation
  125.     Beta Tested for over 2 months, so I'm 99.44% sure it works.
  126.     Decreased amount of time before an unregistered copy expires.
  127.     Added CONVERT.EXE to upgrade pre 2.3 configurations
  128.     Added a 'Reply-To:' field to messages, so even unmapped sites should
  129. be able to recieve replys to messages.
  130.     Much Much more.
  131.  
  132.  
  133.  
  134.                 YOU MUST RUN VUU2CFG BEFORE USING THIS VERSION.
  135.     NEW:    The WAFFLE Admin path is the same as in WAFFLE/STATIC
  136.                 (usually x:\waffle\admin)
  137.     NEW:    The Reply-To: line is entered in the following format:
  138.             *%pil@ness.com OR pil!*@ness.com
  139.             where * is translated into the username when VUUCP is run
  140.                 The VBBS Data path is the same as you have set in VCONFIG
  141.                 The VBBS Db path is the same as you have in VCONFIG
  142.                 The SPOOL path is the path to the directory where outgoing
  143.                         UUCP Mail is stored (usually x:\SPOOL\server)
  144.                         Logging: Produces a LONG log of activity, use
  145.                                 only when reporting bugs/etc unless
  146.                                 you want a huge file of logs...
  147.                         Networkid: VME used to be hardcoded to poll only
  148.                                 With networkid 5, since other people use
  149.                                 other slots now, I made it configurable.
  150.  
  151.  
  152. OPTIONAL: In order to have VME.EXE check outgoing USENet activity and poll:
  153.         Rename the VME.EXE in the VBBS 6.1 archive to:
  154.         "REALVME.EXE" and then rename the "FAKEVME.EXE"
  155.         program to "VME.EXE".  This is NOT recomended if
  156.         you have to make a long distance call to your feed.
  157.  
  158. OPTIONAL: I have included a source mod to modify the VBBS quoting system to
  159.         Meet a defacto-standard of USENet.  The modified structure is only
  160.         used when R>eplying to USENet/Internet messages, and leaves the rest
  161.         unaffected.  *This mod is untested with VBBS 6.11 Beta
  162.  
  163.  
  164. Hope that helps.  Enjoy...
  165.  
  166.  
  167. If you need help, please feel free to call me at my BBS and
  168. be sure to subscribe to the VUUCP/2 support sub in VNet and RushNET.
  169. (look for alt.vuucp coming soon)
  170.  
  171. Registration:
  172.                 Well, quite frankly, this program was a b*tch to write.
  173. I had to decode the data types used by RDG (wouldn't want a co